home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / SCOptions.z / SCOptions
Text File  |  1998-10-30  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSCCCCOOOOppppttttiiiioooonnnnssss((((3333))))                     IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                      SSSSCCCCOOOOppppttttiiiioooonnnnssss((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SCOptions, SCHasOptions - scanner specific options
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccaaaannnnnnnneeeerrrr....hhhh>>>>
  14.  
  15.      iiiinnnntttt SSSSCCCCOOOOppppttttiiiioooonnnnssss((((SSSSCCCCAAAANNNNNNNNEEEERRRR ****ssss))));;;;
  16.  
  17.      iiiinnnntttt SSSSCCCCHHHHaaaassssOOOOppppttttiiiioooonnnnssss((((SSSSCCCCAAAANNNNNNNNEEEERRRR ****ssss))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _S_C_O_p_t_i_o_n_s starts the scanner specific options program for _s.  A scanner
  21.      specific options program provides a user interface allowing the user to
  22.      set scanning parameters that are not a part of the _l_i_b_s_c_a_n(3) interface.
  23.      The options program communicates directly with the scanner driver to set
  24.      scanner specific options, so no further interaction is required by the
  25.      scanning program.
  26.  
  27.      _S_C_H_a_s_O_p_t_i_o_n_s is used to determine whether or not a scanner specific
  28.      options program exists for the scanner _s.
  29.  
  30.      In both functions, _s specifies a connection with a scanner driver
  31.      obtained by a call to _S_C_O_p_e_n(3), _S_C_O_p_e_n_F_i_l_e(3), or _S_C_O_p_e_n_S_c_r_e_e_n(3).
  32.  
  33. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  34.      _S_C_O_p_t_i_o_n_s returns 0 if it successfully started the scanner specific
  35.      options program, and -1 if an error occurred.  If an error occurs,
  36.      _S_C_O_p_t_i_o_n_s sets _S_C_e_r_r_n_o to indicate the reason for the error.
  37.  
  38.      _S_C_H_a_s_O_p_t_i_o_n_s returns 1 if the scanner has a scanner specific options
  39.      program, and 0 otherwise.
  40.  
  41. EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
  42.      _S_C_O_p_t_i_o_n_s will fail under the following circumstances.
  43.  
  44.      SCENOOPTIONS             No options for this scanner
  45.  
  46.      SCEALREADYOPTIONS        Options are already running for this scanner
  47.  
  48.      In addition, _S_C_O_p_t_i_o_n_s may fail as the result of a failed system call, in
  49.      which case SCerrno will be set to a value from <_s_y_s/_e_r_r_n_o._h>.  _S_C_O_p_t_i_o_n_s
  50.      calls the _f_o_r_k(2) and _e_x_e_c_l(2) system calls.
  51.  
  52. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.      _l_i_b_s_c_a_n(3), _S_C_O_p_e_n(3), _f_o_r_k(2), _e_x_e_c(2).
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.